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guide 



These instructions provide information to help you: 

■ Install the C-FCSWAPI Bridge Agent software on a Microsoft Windows OS. 

■ Remove the C-FCSWAPI Bridge Agent, 
"about this guide" topics include: 

■ Overview, page 6 

■ Conventions, page 7 

■ Rack stability, page 9 

■ Getting help, page 10 
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about this guide 



Overview 

This section covers the following topics: 

■ Intended audience 

■ Related documentation 

Intended audience 

This book is intended for use by administrators who are experienced with the 
following: 

■ Fibre Channel technology 

■ HP StorageWorks Fibre Channel switches 

Related documentation 

For a list of corresponding documentation, see the HP StorageWorks HA-Fabric 
Manager release notes. 

The latest information, documentation, and firmware is available on the following 
HP web site: http://hl 8006. wwwl .hp.com/storaqe/saninfrastructure.html . 

Information about Fibre Channel standards is available on the following Fibre 
Channel Industry Association web site: http:/ / www.fibrechannel.org . 
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Conventions 

Conventions consist of the following: 

■ Document conventions 

■ Text symbols 

■ Equipment symbols 

Document conventions 



This document follows the conventions in Table 1. 
Table 1 : Document conventions 



Convention 


Element 


Blue text: Figure 1 


Cross-reference links 


Bold 


Menu items, buttons, keys, tabs, and 
user input in a graphical interface. (Use 
plain text for aHother GUI elements.) 


Italics 


Text emphasis and document titles (not 
CD titles) in body text 


Monospace font 


Command-line user input, commands, 
code, device instances, file and directory 
names, and system responses (output 
and messages) 


Monospace, italic font 


Command-line and code variables 


Blue underlined sans serif font text 

(http://www.hp.com) 


Web site addresses 



Text symbols 

The following symbols may be found in the text of this guide. They have the 
following meanings: 



WARNING: Text set off in this manner indicates that failure to follow 
/ i \ directions in the warning could result in bodily harm or death. 



HP StorageWorks C-FCSWAPI SDK Bridge Agent installation instructions 



7 



about this guide 



Caution: Text set off in this manner indicates that failure to follow directions 
could result in damage to equipment or data. 



Tip: Text in a tip provides additional help to readers by providing nonessential or 
optional techniques, procedures, or shortcuts. 



Note: Text set off in this manner presents commentary, sidelights, or interesting points 
of information. 



Equipment symbols 



The following equipment symbols may be found on hardware for which this guide 
pertains. They have the following meanings: 



t\ //\ enc ' osec ' surface or area of the equipment marked with these 

!\/7\ symbols indicates the presence of electrical shock hazards. Enclosed 
area contains no operator serviceable parts. 

WARNING: To reduce the risk of personal injury from electrical shock 
hazards, do not open this enclosure. 



•\ A n y RJ-45 receptacle marked with these symbols indicates a network 

I \VJW interface connection. 

WARNING: To reduce the risk of electrical shock, fire, or damage to the 
equipment, do not plug telephone or telecommunications connectors 
into this receptacle. 
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-\ A, Any surface or area of the equipment marked with these symbols 
' \ indicates the presence of a hot surface or hot component. Contact with 

this surface could result in injury. 

WARNING: To reduce the risk of personal injury from a hot component, 
allow the surface to cool before touching. 



Power supplies or systems marked with these symbols indicate the 
presence of multiple sources of power. 

WARNING: To reduce the risk of personal injury from electrical 
shock, remove all power cords to completely disconnect power 
from the power supplies and systems. 



Any product or assembly marked with these symbols indicates that the 
component exceeds the recommended weight for one individual to 
handle safely. 

WARNING: To reduce the risk of personal injury or damage to the 
equipment, observe local occupational health and safety requirements 
and guidelines for manually handling material. 




Rack stability 

Rack stability protects personnel and equipment. 



/£\ WARNING: To reduce the risk of personal injury or damage to the 
/ I \ equipment, be sure that: 

■ The leveling jacks are extended to the floor. 

■ The full weight of the rack rests on the leveling jacks. 

■ In single rack installations, the stabilizing feet are attached to the rack. 

■ In multiple rack installations, the racks are coupled. 

■ Only one rack component is extended at any time. A rack may become 
unstable if more than one rack component is extended for any reason. 
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Getting help 

If you still have a question after reading this guide, contact an HP authorized 
service provider or access the following HP web site: http:/ /www.hp.com . 

HP technical support 

Telephone numbers for worldwide technical support are listed on the following 
HP web site: http://www.hp.com/ support/ . From this web site, select the country 
of origin. 



Note: For continuous quality improvement, calls may be recorded or monitored. 



Be sure to have the following information available before calling: 

■ Technical support registration number (if applicable) 

■ Product serial numbers 

■ Product model names and numbers 

■ Applicable error messages 

■ Operating system type and revision level 

■ Detailed, specific questions 

HP storage web site 

The HP web site has the latest information and drivers on this product. Access the 
following HP web site: http:/ / www.hp.com/ country/ us/ eng/ prodserv/ storage.html . 
From this web site, select the appropriate product or solution. 

HP authorized reseller 

For the name of your nearest HP authorized reseller: 

■ In the United States, call 1-800-345-1518 

■ In Canada, call 1-800-263-5868 

■ Elsewhere, see the following HP web site for locations and telephone 
numbers: http://www.hp.com . 
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Installation instructions 



This document provides instructions for installing and uninstalling the Bridge 
Agent used by the C-FCSWAPI Software Development Kit (SDK). These 
instructions pertain only to the Microsoft Windows operating systems. This 
chapter contains the following sections: 

■ C-FCSWAPI Bridge Agent overview, page 12 

■ Installing the C-FCSWAPI Bridge Agent, page 12 

■ Removing the C-FCSWAPI Bridge Agent, page 12 
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C-FCSWAPI Bridge Agent overview 



The C-based Fibre Channel switch application programming interface 
(C-FCSWAPI) is a library of switch-management functions callable from an 
application program written in C or C++. C-FCSWAPI enables software to 
communicate with switches, instead of requiring a user to interact manually with a 
graphical user interface (GUI) or command line interface (CLI). 

C-FCSWAPI proxy connections route data from the C-FCSWAPI library to the 
C-FCSWAPI Bridge Agent and then from the C-FCSWAPI Bridge Agent to 
HAFM. To support this connection type, the C-FCSWAPI Bridge Agent must be 
installed on the HAFM appliance where HAFM is installed. 



Note: Only one Bridge Agent can function on a system. Before installing the 
C-FCSWAPI Bridge Agent, remove any Bridge Agent that exists on the system. 



To install the C-FCSWAPI Bridge Agent, use the following procedure: 

1. Insert the installation CD into the CD-ROM drive. 

2. Double-click the /Open Bridge Agent Installer/ 
BridgeAgentlnstall . exe file. 

The installer program opens and guides you through the installation process. 

3. Click Next at the Introduction window. The Important Information window is 
displayed. 

4. Click Install. 

The installer starts the Bridge Agent and portmap as system services. 



To remove the Bridge Agent for Windows, perform the following procedure: 

1. Click Start > Settings > Control Panel. The Control Panel window is 
displayed. 

2. Double-click Add/Remove Programs. The Add/Remove Programs window 
is displayed. 

3. Select the Bridge Agent program and click Change/Remove. 
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Removing the 



C-FCSWAPI Bridge Agent 
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